Редактирование роли

Запрос позволяет редактировать запись о роли пользователя.

Синтаксис запроса

PUT https://business.taxi.yandex.ru/api/1.0/client/{идентификатор клиента}/role/{идентификатор роли}

🔴 Рекомендуем использовать API 2.0. Поддержка API 1.0 в будущем будет прекращена.

Заголовки запроса:

Authorization

OAuth-токен. Процесс получения токена описан в разделе Начало работы.

Новые данные о роли передаются в теле запроса в формате JSON:

Поле Описание Формат
name Название новой роли. Данный параметр должен быть уникальным относительно уже существующих ролей клиента. Строка
classes Список доступных тарифов. Массив
limit Ограничения на сумму, которую пользователь может потратить на поездки за календарный месяц. Строка
department_id Идентификационный номер подразделения. Строка
no_specific_limit Признак того, что у данной роли отсутствует ограничение на общую стоимость поездок. Возможные значения:
- true — лимит отсутствует. Значение, переданное в параметре limit использоваться не будет.
- false — лимит присутствует.

Необязательное поле.		 Логическое
restrictions Блок с информацией об ограничениях роли. Массив объектов
type Тип ограничения. Возможные значения:
- weekly_date — ограничения по дням недели.
- range_date — ограничения по дате.		 Строка
days Дни недели, в которые доступен заказ поездки. Возможные значения:
- mo — понедельник.
- tu — вторник.
- we — среда.
- th — четверг.
- fr — пятница.
- sa — суббота.
- su — воскресенье.

Поле используется только для ограничения с типом weekly_date.		 Массив строк
start_time Время, начиная с которого будет доступен заказ. Формат значений: ЧЧ:ММ:СС.

Поле используется только для ограничения с типом weekly_date.		 Строка
end_time Время, до которого будет доступен заказ. Формат значений: ЧЧ:ММ:СС.

Поле используется только для ограничения с типом weekly_date.		 Строка
start_date Дата, начиная с которой будет доступен заказ.

Формат значений: YYYY-MM-DDThh:mm:ss

Поле используется только для ограничения с типом range_date.		 Строка
end_date Дата, до которой будет доступен заказ.

Формат значений: YYYY-MM-DDThh:mm:ss

Поле используется только для ограничения с типом range_date.		 Строка
geo_restrictions Блок с информацией о разрешенных районах поездок. Массив объектов
geo_restrictions.source Идентификатор района начала поездки.

Если поле не задано, то разрешен любой район.

Должно быть задано хотя бы одно из полей source и destination.		 Строка
geo_restrictions.destination Идентификатор района конца поездки.

Если поле не задано, то разрешен любой район.

Должно быть задано хотя бы одно из полей source и destination.		 Строка

Описание полей ответа

В случае успеха вернется пустой ответ с кодом 200.

Пример запроса

PUT https://business.taxi.yandex.ru/api/1.0/client/a2...d09/role/a94e20f6f5174c2ba727b9aae5935abf
...
Authorization: <OAuth-токен>

    {
            "name": "Тестовая роль 1",
            "classes": [
                "econom"
            ],
            "limit": "200000",
            "department_id": "233e725b0511459da7b38cb24f2d8fd7",  
            "restrictions": [
                {
                    "type":"weekly_date",
                    "end_time":"22:00:00",
                    "start_time":"23:59:00",
                    "days":["mo","tu","fr"]
                }
            ],
            "geo_restrictions": [
                {
                    "source": "geo_restriction_id1", 
                    "destination": "geo_restriction_id2"
                },
                {
                    "source": "geo_restriction_id3"
                }
            ]
    }

Возможные коды ответа

Ответ на данный запрос может содержать следующие стандартные HTTP-коды:

  • 200 — запрос выполнен успешно.
  • 400 — в запросе был передан неизвестный параметр или параметр с недопустимым значением.
  • 401 — был передан неверный OAuth-токен.
  • 403 — у клиента не хватает прав на выполнение данного запроса.
  • 404 — указанная запись не найдена.
Предыдущая
Создание новой роли
Следующая
Удаление роли